home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD 5.bin / workbench / tools / czesc_2 / hold / hold.doc < prev    next >
Text File  |  1992-01-18  |  6KB  |  132 lines
  1.  
  2.                                    hold
  3.                                    ----
  4.          Documentation for version 1.43b, on September 14th, 1991
  5.  
  6.                               by Bruno Costa
  7.  
  8.  
  9. WARNING
  10.  
  11.   Although  this  program  is freely distributable (see COPYRIGHT below), I
  12. would  appreciate  if  you  take the time to write me a line or two (E-Mail
  13. please)  if  you  are  using  any of my programs or if you have any kind of
  14. ideas  or  suggestions  (This is not too much to ask, is it?).  If you feel
  15. particularly  generous,  I  would  like  to  receive a disk with any useful
  16. programs you have written, preferrably with source.  Thanks!
  17.  
  18.  
  19. DESCRIPTION
  20.  
  21.   Hold  is  a  background utility primarily designed to hold down the right
  22. mouse  button  for  you.   This  means that, to access a menu, you may just
  23. *click*  the  right mouse button, browse through the items (withouth having
  24. to  hold  any button), and when you are done, just *click* the mouse button
  25. again.   Users  of  the  original Commodore mouse, whose switches where not
  26. very stable (specially after some use), will appreciate this program.  This
  27. does not mean that users of better quality mouses (like the A3000 one) will
  28. not  benefit  from  the  use  of this program.  Hold provides an additional
  29. utility:  window auto-activation (SunMouse-like).
  30.  
  31.   Note  that  both  functions  of Hold have an extra level of compatibility
  32. with  normal  Amiga  applications  (unlike  many  known similar utilities),
  33. minimizing  the  conflicts  of  this utility with the interface expected by
  34. most  programs.   The  window auto-activator, for instance, will not try to
  35. activate  the window under the mouse pointer when you are moving the mouse.
  36. Instead,  it  will  do  that  just  after  the  mouse is quiet for a while,
  37. minimizing  the  overhead  of  meaningless and frustrating activations that
  38. were  not desired.  The menu-button-holder is smart enough to know when you
  39. are  clicking  the  menu  button (it will hold the button for you then) and
  40. when you are holding the button yourself (it will do nothing in this case).
  41. So,  if  keep  selecting menus just like you did before (holding the button
  42. instead  of  clicking  it)  you  will not even notice if Hold is installed.
  43. Note also that both options can be disabled, so that you might use just one
  44. of Hold functionalities if you wish to.
  45.  
  46.   Hold works both under WB 1.3 and WB 2.0 (although it is not a commodity).
  47.  
  48.  
  49. OPTIONS
  50.  
  51.   usage: Hold [-a] [-h] [-q] [?]
  52.  
  53.   Option '?' gives the small usage message above. Option 'a' is used to
  54. disable the auto-activator, and option 'h' the menu-button-holder - the
  55. default is to install both things. Option 'q' is used to remove Hold from
  56. memory.
  57.  
  58.  
  59. EXAMPLES
  60.  
  61.   To install Hold (with both the auto-activator and the menu-button-holder
  62. active), use:
  63.  
  64.   > Hold
  65.  
  66.   To de-install Hold:
  67.  
  68.   > Hold -q
  69.  
  70.  
  71. BUGS
  72.  
  73.   Special   care  has  been  taken  to  minimize  conflicts  with  existing
  74. applications.   Two  main areas of conflict exist:  some programs treat the
  75. currently active window as special (Workbench, for instance), and other use
  76. the right mouse button for purposes other than selecting menus (like Deluxe
  77. Paint).
  78.  
  79.   The  first  problem is minimized by the way the auto-activator works.  If
  80. you  want  to cleanup a window in Workbench, for instance, you may activate
  81. the window (by moving over it) and move (without stopping) to the menu bar,
  82. immediately  pressing  the  menu  button  and selecting cleanup; or you may
  83. activate  the  window,  press  the  mouse button (hold or click) and select
  84. cleanup.   In  both cases, the original window will be kept active, so that
  85. cleanup  will  behave as expected (this is partly due to the fact that both
  86. functions  are  performed  by  the  same  program:   if  you  use  just the
  87. menu-button-holder  of  Hold  and an external auto-activator, deadlocks may
  88. occur).
  89.  
  90.   The  second  problem  does  not exist if you *hold* the menu button for a
  91. while  to  do  what you want, e.g., to draw a freehand line in Deluxe Paint
  92. using  the  background  color,  you would hold the right mouse button, move
  93. around  and  then release it - this works either using Hold or not.  On the
  94. other  hand,  if  an  operation needs a click in the right mouse button the
  95. problem  will  become  noticeable.   If you needed to strike a brush in the
  96. background color in Deluxe Paint, you would normally need to click the menu
  97. button  just  once;  with Hold installed, you would need to click it twice.
  98. This  kind of problem could possibly be minimized even further by examining
  99. the window flags to see if a particular window uses menus or not.
  100.  
  101.  
  102. AUTHOR
  103.  
  104.   The  accompanying  program  and  this documentation were written by Bruno
  105. Costa.  He can be reached in the following ways:
  106.  
  107.   E-Mail: bruno@brlncc.bitnet  (InterNet)
  108.           bruno at BRLNCC        (BitNet)
  109.  
  110.   Mail:   Bruno Costa
  111.           Rua Almirante Guilhem 454/102 bloco 1
  112.           Leblon - Rio de Janeiro
  113.           RJ 22440
  114.           BRAZIL
  115.  
  116.  
  117. COPYRIGHT
  118.  
  119.   This program is copyrighted by Bruno Costa.  It may be freely distributed
  120. if  and  only if the source code, the documentation and the executables are
  121. provided  in  original form.  It may be included in Public Domain/Shareware
  122. compilations,  like  the  one  organized  by  Fred  Fish, as long as just a
  123. nominal fee is charged for each disk (no more than US$10 per disk), and may
  124. also be uploaded to BBS's or network services like BIX and CompuServe.
  125.  
  126.  
  127. DISCLAIMER
  128.  
  129.   The author makes no warranty of any kind with respect to this product and
  130. explicitly  disclaims  any implied warranties of merchantability or fitness
  131. for  any  particular  purpose.
  132.